--------------------------------------------------------------------------------
README for "On the Value of Birth Weight"
Oxford Bulletin of Economics and Statistics
Damian Clarke, Sonia Oreffice & Climent Quintana-Domeque
yyyy-mm-dd:2021-02-01
--------------------------------------------------------------------------------
This folder contains replication material and data for tables, figures and calc-
ulations in the paper "On the Value of Birthweight", published in the Oxford Bu-
lletin of Economics and Statistics. All analysis scripts should be run in Stata
and will replicate results for any version of Stata >= 11.0.  Data are provided
as both Stata-native dta files, and additionally as a raw csv file in case of
software access limits. This README documents usage of code and data.

This folder contains four sub-directories:
   |_ data:    contains all data used in the paper
   |_ source:  contains all source code used for replication of results
   |_ results: tables and figures provided in the paper
   |_ log:     a log file produced when running each piece of source code

Please note that all data is identical to those used in the paper with one minor
exception.  Geographic locations have been modified with random noise to ensure
that no individuals can be identified. Given this, the replicated Appendix Figu-
re A1 will differ from that in the paper. All other figures and tables will be
unaltered.

To replicate all results, the script dceAnalysis.do in the "source" folder sh-
ould be run in Stata.  There are a small number of user-written ado files which
are required to run (listtex, mixlogit, estout, spmap).  If these ado files are
not available on the operating system used to run this code, they will be auto-
matically installed from Stata's SSC. In case these ados are not available, and
a web-connection is not available, the script will not replicate correctly until
these files have been installed, or the computer is connected to the internet.
The only required change to the replication script is that the MAIN global on
line 20 of the script should be changed to indicate the location of these repli-
cation materials on your computer. For example, if the replication materials are
located in a folder called "/home/replication", line 20 of dceAnalysis.do defin-
ing the MAIN global should be set as:

    global MAIN "/home/replication/"

A log file will be exported to the "log" subdirectory.  Tables are all exported
as tex files, and figures are all exported as eps files (to sub-folders within
the results folder). If you desire to replicate the precise format of these tab-
les and figures as presented in the paper, you can compile the tex file in the
main directory using the following command:

  pdflatex OBES-20-065-article.tex    [TO REPLICATE THE ARTICLE]
  pdflatex OBES-20-065-appendix.tex   [TO REPLICATE THE ONLINE APPENDIX]

No changes need be made to the tex files, as they all refer to the location whe-
re results are automatically exported. There are a small number of figures (inc-
luding experimental screen shots) which do not need to be replicated.  These are
included in the "results/auxiliary" sub-folder to allow for the compilation of
the tex files.


For queries regarding data generation or other replication details, contact
Damian Clarke at

  dclarke [AT] fen.uchile.cl

or

  damian.clarke [AT] protonmail.com.
  
--------------------------------------------------------------------------------
